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RELATED APPLICATIONS 

This application is related to a prior US Patent Application filed February 
4, 2000, titled "Host-Specified USB Device Requests", serial number 09/498,056, 
which is hereby incorporated by reference. 

TECHNICAL FIELD 

The following description relates generally to the use of peripheral devices 
with software applications. More specifically following description relates to the 
use of device-specific information and resources with such software applications. 

BACKGROUND 

The Universal Serial Bus (USB) is a cable bus that supports data exchange 
between a host computer and a wide range of simultaneously accessible peripheral 
devices. The attached peripheral devices share USB bandwidth through a host- 
scheduled, token-based protocol. The bus allows peripherals to be attached, 
configured, used, and detached while the host and other peripherals are in 
operation. 

The USB is defined by a specification that is approved by a committee of 
industry representatives. The specification covers all aspects of USB operation, 
including electrical, mechanical, and communications characteristics. To be called 
a USB device, a peripheral must conform to this very exacting specification. 

USB device information is typically stored in so-called "descriptors" or 
request codes — data structures formatted as specified by the USB specification. 
Descriptors are used in a USB system to define "device requests" from a host to a 
peripheral device. A device request is a data structure that is conveyed in a 
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"control transfer" from the host to the peripheral device. A control transfer 
contains the following fields: 

• bmRequestType — a mask field indicating (a) the direction of data 
transfer in a subsequent phase of the control transfer; (b) a request 
type (standard, class, vendor, or reserved); and (c) a recipient 
(device, interface, endpoint, or other). The primary types of 
requests specified in the "request type" field are the "standard" 
and "vendor" types, which will be discussed below. 

• bRequest — a request code indicating one of a plurality of different 
commands to which the device is responsive. 

• w Value — a field that varies according to the request specified by 
bRequest. 

• wlndex — a field that varies according to request; typically used to 
pass an index or offset as part of the specified request. 

• wLength — number of bytes to transfer if there is a subsequent data 
stage. 

All USB devices are supposed to support and respond to "standard" 
requests — referred to herein as "USB-specific" requests. In a USB-specific 
request, the request type portion of the bmRequestType field contains a predefined 
value indicative of the "standard" request type. 

Each different USB-specific request has a pre-assigned USB-specific 
request code, defined in the USB specification. This is the value used in the 
bRequest field of the device request, to differentiate between different USB- 
specific requests. For each USB-specific request code, the USB specification sets 
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forth the meanings of w Value and wlndex, as well as the format of any returned 
data. 

USB devices can optionally support "vendor" requests — referred to herein 
as "device-specific" requests. In a device-specific request, the request type 
portion of the bmRequestType field contains a predefined value to indicate a 
"vendor" request type. In the case of device-specific requests, the USB 
specification does not assign request codes, define the meanings of w Value and 
wlndex, or define the format of returned data. Rather, each device has nearly 
complete control over the meaning, functionality, and data format of device- 
specific requests. Specifically, the device can define its own requests and assign 
device-specified request codes to them. This allows devices to implement their 
own device requests for use by host computers, and provides tremendous 
flexibility for manufacturers of peripherals. 

The inventors have discovered a need for a similar feature that would 
benefit various hosts, application programs, host operating systems, hardware 
manufacturers (OEMs), and Independent Hardware Vendors (IHVs). Specifically, 
designers of application programs and operating systems would value the 
opportunity to define their own device requests (and the associated responses), and 
to have such requests supported in a uniform way by compatible peripherals. 
Moreover, OEMs and IHVs (makers and distributors of USB devices) would value 
the ability to supply additional USB device-specific information to the hosts, 
application programs and host operating systems in response to such device 
requests. However, the different request types supported in the bmRequestType 
field of a USB device request do not include a "host" type of request. 



tee ©hay es pic 60*324-9256 



3 



1219001347 MS J -705 US. P03. CLEAN COPY 



I 

1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



x 



As an example of this need for a host type of request, consider that a typical 
USB device installation scenario typically involves customer use of installation 
media such as OEM/IHV supplied installation disks (e.g., a floppy disk) and/or 
setup computer program applications. Such installation media are generally 
shipped with the device or made available over the Internet. Installation media 
typically provide device-specific settings and resources such as: (a) a device driver 
to control the device; (b) one or more user interface elements; and (c) an 
information file (e.g., an ".inf ' file) to specify names and locations of the setting 
and resources. Such user interface (UI) elements include, for example, icons, 
fonts, pictures, labels, help pages, Universal Resource Locator (URL) Internet 
links, and the like. 



Aj/ Upon installation, a USB device^pically provides an operating system 
with USB standard class and subckfss codes which are used to determine whether 
a generic, or default devicp^ariver can be used to control the device. If so, a 
special OEM/IHV spffplied device driver may not be necessary to control the 
device. Thus, itis often unnecessary for customers to install the device drivers 
provided oft the installation media for the device to function properly upon being 
attacl^a. 

However, as USB devices gain popularity, OEMs/IHVs typically want to 
load other device-specific brand information to allow an operating system to 
present a shell or user interface information that is appropriate to a particular USB 
device. Such information includes brand icons, fonts, pictures, labels, help pages, 
Universal Resource Locator (URL) Internet links, and the like. Thus, even though 
an installation media supplied device driver may not be required, an installation 
media including an information file still typically needs to be distributed with the 
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device to specify any device-specific shell or user interface information. 
(Hereinafter, "shell" and/or "user interface" information is often referred to 
generally as "user interface", or "UI" information). 



One of the benefits of using a USB device is the reduced the amount of 
interaction typically required of a user to attach and configure a device. This ease 
of use has typically reduced the amount of device installation related customer 
support that OEMs/IHVs have needed to provide. Thus, when a default device 
driver can be used to control a device, it would be beneficial (both in terms of 
customer ease of use and in terms of the amount of customer support typically 
required) if installation media /such as installation disks or setup programs were 
not required to be distributed Lo specify device-specific UI information. Rather, an 
operating system could query a device for this additional device specific 
information. Unfortunately, because host-specific USB requests are not provided 
or considered by the USB specification, there are no standards that allow a vendor 
to provide additional USB device-specific information in a USB device in a format 
that is determined by An operating system. 

Accordingly, the invention arose out of concerns associated with providing 
a host-specific device request that solves the problems described above. 

SUMMARY 

The described system and procedure provide for storing device-specific UI 
information into firmware on a USB device. Responsive to receiving a host 
specific device request, the USB device communicates the device specific 
information to a requestor such as an operating system or other computer program 
application. Thus, the system and procedure allow OEMs/IHVs to provide 
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additional brand specific information in a USB device in a format that can be 
determined by an operating system. Moreover, the system and procedure allows 
OEMs/IHVs to store device-specific UI information in the firmware of a USB 
device such that installation media does not need to be distributed with each USB 
device to specify the device-specific information. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Fig. 1 is a block diagram of an exemplary host/peripheral USB system. 

6^ 

Fig. 2 shows top-level methodological aspects of an exemplary procedure 
to obtain a device-specific request code for computer to use when making a host- 
specific device request. 

Fig. 3 is a flowchart diagram that shows detailed aspects of an exemplary 
procedure to obtain a device-specific request code. Fig. 4 is a block diagram 
showing aspects of an exemplary data structure for an extended property 
descriptor. 

DETAILED DESCRIPTION 

The following description sets forth a specific embodiment of a system and 
procedure that incorporates elements recited in the appended claims. The 
embodiment is described with specificity in order to meet statutory requirements. 
However, the description itself is not intended to limit the scope of this patent. 
Rather, the inventors have contemplated that the claimed subject matter might also 
be embodied in other ways, to include different elements or combinations of 
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elements similar to the ones described in this document, in conjunction with other 
present or future technologies. 

Exemplary System 

Fig. 1 shows a system 100 wherein device-specific settings and resources 
are stored on the USB device's firmware in a format specified by an operating 
system. These settings and resources are made available to the operating system 
and applications through a host-specified device request. Thus, the system and 
procedure of this implementation simplifies device installation scenarios and 
allows operating systems to identify an attached USB device and/or provide user 
interfaces that are appropriate for the device. 

System 100 is compatible with the Universal Serial Bus (USB) 
specifications. These specifications are available from USB Implementers Forum, 
which has current administrative headquarters in Portland, Oregon (current 
Internet URL: www.usb.org ). 

System 100 includes a host computer 102 and a USB peripheral device 114. 
The respective functionality of the computer and peripheral device is embodied in 
many cases by computer-executable instructions, such as program modules, that 
are executed by respective processors. Generally, program modules include 
routines, programs, objects, components, data structures, etc. that perform 
particular tasks or implement particular abstract data types. 

Computer 102 is a conventional desktop PC or other type of computer. 
Computer 102 has one or more processors 104 and one or more forms of 
computer-readable memory media 106 such electronic memory, magnetic storage 
media, optical storage media, or some other type of data storage. Programs are 
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stored in memory 106 from where they are executed by processor 104. In this 
example, such programs include an operating system 108 such as the Microsoft 
"Windows"® family of operating systems. The operating system provides various 
system services to one or more application programs 110 running on the computer. 

The computer also has a USB communications driver and port 112. The 
USB port is supported by operating system 108. To communicate with a USB 
device, an application program 110 makes high-level calls to system services 
provided by the operating system. The system services take care of lower level 
communications details, and return requested information to the application 
program. 

Peripheral device 114 is one of any number of different types of USB 
devices such as a data storage device, a digital camera, a scanner, a joystick, game 
pad, steering unit, mouse, stylus, digital speaker, microphone, display device, and 
the like. Peripheral device 114 has one or more processors 116 and one or more 
forms of computer-readable memory media 118, including at least some form of 
non-volatile memory media 120. 

The peripheral device 114 has a USB port 126 and communicates with 
computer 102 via a USB communications medium 128. The peripheral device 
also has operating logic 124, which is executed by processor 116 to detect control 
actuation and for communicating with computer 102 across communication path 
128. 

^3/ The peripheral device 114 responds/ to requests from the host computer 102 
across the communication path 128. /These requests are made using control 
transfers where setup packets (not shown) are exchanged. The USB device returns 
descriptors in response to exchanging such setup packets. Although the USB 
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Specification defines a number of dffferent standard, class and vendor specific 

descriptors, an extended property/descriptor 122 is not defined in the USB 

specification. The extended property descriptor includes UI information that 

pertains to the peripheral devic/. The UI information can be in any format such as 

a format specified by an operating system vendor. The extended property 

descriptor allows OEMs/IHVs to device specific UI information such as store 

icons, fonts, pictures, labels, help pages, Universal Resource Locator (URL) 

Internet links, and the like/ in non- volatile memory 1 1 8 of the device. 

In this implementation, prior to using the peripheral device, the computer 

sends a host-specific request to the peripheral device requesting device-specific UI 

information corresponding to the peripheral device. Such device specific UI 

information can be used, for example, to influence the behavior of an operating 

system UI shell , or to influence the behavior ofother non-kernel components. 

For example, a camera that exposes a "Volume" interface (a type of a disk 
* 

storage device interface), is typically represented by an operating system such as a 
Microsoft "Windows"® operating system, as a disk storage device such as a 
logical drive. However, by accessing the extended property descriptor 122 
through a host-specific device request, the operating system can obtain additional 
information that corresponding to the camera. This additional information allows 
the operating system to display a more particular, or "device-centric" interface that 
illustrates the device as a "camera", rather than merely illustrating the device as a 
diskstorage device. Hereinafter, such UI information is often referred to as a 
device's "extended properties", or "properties". 

In response to the host-specific request, the peripheral device 114 provides 
the extended property descriptor 122 to a requestor such as the host computer 



lee©hayes poc »m24-«5b 



9 



1 2 1900 1 347 MSI- 705 US. P03. CLEAN COPY 



t 

1 

2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 



102. Using the extended property descriptor, the requestor locates data 
corresponding to the peripheral device 114, and extracts the UI information. The 
operating system can use the UI information for any number of purposes such as 
to display text or "special .names" that correspond to the device, icons, 
informational URLs, and the like. 

The operating system 108 optionally stores the UI information provided by 
the extended configuration descriptor into a configuration file (not shown) such as 
a registry provided by a Microsoft Windows® operating system. The stored 
information can be subsequently accessed by other computer program 
applications. 

Exemplary Procedure to Obtain a Device Specific Request Code 

Fig. 2 shows top-level methodological aspects of an exemplary procedure 
to obtain a device-specific request code for computer to use when making a host- 
specific device request. Generally, a new, non-USB-specific device request is 
defined for use with various USB peripherals. This request is referred to herein as 
a host-specific device request. Because of the described methodology, the host- 
specific device request can be defined by the manufacturer of an operating system 
or application program, and can then be made available to peripheral vendors so 
that they can support and respond to the newly defined request. As an example, an 
OS manufacturer might define a new descriptor allowing peripherals to return 
device-specific data and resources to an operating system in a data format that is 
determined by the operating system. This would allow the operating system to use 
a single device request to obtain this information from various different 
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peripherals (assuming those peripherals are configured to support the new device 
request). 

In an initialization phase 200, the host sends a request to the peripheral in 
the form of a USB-specified device request. The request is for a device-specific 
request code — of the device's choosing — that will be subsequently be used as the 
request code for the host-specific device request. 

Once this request code is obtained, it is used in a subsequent phase 202 to 
initiate the host-specified device request to obtain the extended property descriptor 
122 of Fig. 1. Specifically, the host specifies the request code as the bRequest 
value in a control transfer. The actual protocol of this device request (meanings of 
blndex, bValue, and the like) is as specified in the definition of the host-specific 
device request. Phase 202 is repeated as desired during subsequent operation, 
without repetition of initialization phase 200. 

Fig. 3 shows more details regarding the initialization phase 200. The host 
performs an action 300 of sending a GETDESCRIPTOR device request to the 
peripheral device. The GET DESCRIPTOR device request is a standard, USB- 
specific request, identified in a control transfer by the GET DESCRIPTOR 
request code {bRequest = GET DESCRIPTOR). The fields of the control transfer 
(discussed above in the background section) have values as follows: 

• bmRequestType = 10000000 (binary), indicating a "device-to- 
host" transfer, a "standard" or "USB-specific" type request, and a 
device recipient. 

• bRequest = GET DESCRIPTOR. This is a constant (six) defined 
by the USB specification 
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w Value = 03EE (hex). The high byte (03) indicates that the 
request is for a "string" descriptor, and the low byte is an index 
value that is predefined as a constant in the definition of the host- 
specified device request. In this example, it has been defined as 
EE (hex), but could be predefined as any other value. 

• w Index = 0. 

• wLength =12 (hex). This is the length of a host-specific request 
descriptor that will be returned in response to this request. In the 
described example, the length is 12 (hex). 

• data — returned host-specific request descriptor. 

A compatible USB device is configured to respond to a request such as this 
(where w Value = 03EE (hex)) by returning a host-specific request descriptor such 
as the extended property descriptor 122 of Fig. 1. The extended property 
descriptor is not defined by the USB standard, but has fields as defined in the 
following discussion. The host-specific request descriptor designates a device- 
specific request code that will work on this device to initiate the host-specific 
request code. In other words, the manufacturer of the device can select any 
device-specific request code, and associate it with an implementation of the host- 
specific device request. 

More specifically, the device receives the GETDESCRIPTOR device 
request (block 302) and performs a decision 304 regarding whether the index 
value (the second byte of w Value) corresponds to the predetermined value (EE 
(hex)). This predetermined value is a value that is chosen to be used specifically 
for this purpose. 
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If the index value does not correspond to the predetermined value, at block 
305 the device responds in an appropriate way, usually by returning some other 
descriptor that corresponds to the index value. If the index value does correspond 
to the predetermined value, an action 306 is performed of returning the host- 
specific request descriptor to the host. 

The host-specific request descriptor includes, for example, the following 

fields: 

• bLength — the length of the descriptor (12 (hex) in this example). 

• bDescriptorType — the type of descriptor (string type in this 
example). 

• qwSignature — a signature confirming that this descriptor is indeed 
a descriptor of the type requested. The signature optionally 
incorporates a version number. For example, in the described 
example MSFT100 indicates that this descriptor is for an "MSFT" 
host-specific device request, version "100" or 1.00. 

• bVendorCode — the device-specific request code that is to be 
associated with the host-specified device request. 

• bPad — a pad field of one byte. 

The host receives the host-specific request descriptor (block 308) and then 
performs an action 310 of checking or verifying the signature and version number 
found in the qwSignature field. The correct signature confirms that the device is 
configured to support host-specific request codes. If either the signature or 
version number is incorrect, the host assumes at block 3 1 1 that the device does not 
support host-specific request codes, and no further attempts are made to use this 
feature. 
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. The signature field of the host-specific request descriptor block is what 
provides backward compatibility. A non-compatible device (one that doesn't 
support host-specific request codes) might use the predetermined w Value 03EE 
(hex) to store some other string descriptor, which will be returned to the host 
without any indication of problems. However, this will become apparent to the 
host after it examines the data in the location where the signature is supposed to 
be. If the signature is not found, the host knows that the returned descriptor is not 
of the type requested, and will assume that the device does not support host- 
specific request codes. 

If the signature and version are confirmed in block 310, the host at block 
312 reads the device-specific request code from the bVendorCode field, and uses it 
in the future as a host-specific request code, to initiate the host-specific device 
request. When using the device, the host sends the host-specific device request by 
specifying the obtained device-specific request code as part of a control transfer. 
The device responds by performing one or more predefined actions or functions 
that correspond to the host-specific device request, in accordance with the 
specification of the host-specific device request. 

The host-specific device request itself is in the format of a normal USB 
control transfer, including the fields discussed in the "Background" section above. 
The bRequest field is set to the value of the bVendorCode field of the host-specific 
request descriptor, which was earlier obtained from the peripheral device. The 
bmRequestType field is set to 11000001 (binary), indicating a device-to-host data 
transfer, a "vendor" or device-specific request type, and a device recipient. 
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The w Value and wlndex fields are used as defined by the definition of the 
host-specific device request. The wLength field indicates the number of bytes to 
transfer if there is a subsequent data transfer phase in the device request. 

In a current implementation of this system, the host-specific device request 
is used to request one of a plurality of available host-defined string descriptors 
from the device. The wlndex field of the host-specific device request indicates 
which of the plurality of strings are to be returned. The device returns the 
descriptor referred to by wlndex. 

The techniques described above allow an operating system designer to 
specify informational descriptors that devices can implement to provide additional 
data about themselves — data that is not directly addressed by the USB 
specification. For example, the techniques described above advantageously allow 
an operating system designer to specify the extended property descriptor 122 of 
Fig. 1, which is described in greater detail below in reference to Fig. 4 and Tables 
1-2. Moreover, the techniques provide these advantages while retaining backward 
compatibility and without requiring changes to the USB specification. 

Exemplary Data Structures 

Fig. 4 shows elements of an exemplary data structure of property descriptor 
122. The property descriptor is an example of a host-specific request descriptor as 
described above. The property descriptor includes a header section 400 and a 
custom property section 402. The header section includes a number of elements 
404 that describe the custom property section. The custom property section 
includes information corresponding to one or more control properties 406. Each 
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instance of a control property 406 encapsulates information corresponding to a 
single custom property for the peripheral device 114 of Fig. 1. 

Header section 400 stores information about the remaining portions of the 
extended property descriptor 122. Header section 400 includes the following 
fields: 

• dwLength — the total length of the extended property descriptor; 

• bcdVersion — the version number of the extended property 
descriptor; 

• wlndex — is used to identify this particular extended property 
descriptor. 

• wCount — the total number of control property entries 406 in the 
custom property section 402. 

Using this information, an operating system or computer program application can 
parse the following custom property section 402. 

Custom property section 402 is of variable size because it includes one or 
more custom property entries 406. Each control property section includes 
information that corresponds to a single custom property for the peripheral device 
114 of Fig. 1. The custom property section includes the following fields: 

• dwSize — the total length of this particular custom property entry, 
(in one implementation, this includes header fields as well as name 
and property data.) 

• dwPropertyDataType — the data type of the data that is stored in the 
property data buffer (indicated below by bPropertyData field); 
wPropertyNameLength — the size of the property name; 

• bPropertyName — the name of the property; 
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dwPropertyDataLength — the total size of the property data; 
bPropertyData — the property data. 

Example Property Descriptor Use 

For an operating system to use a property descriptor stored on a device, the 
device must first provide information to the operating system that indicates that 
the device supports host-specific device requests. In this implementation, this is 
accomplished by storing the string descriptor shown in TABLE 1 at index OxEE 
on the USB device. The string descriptor defines an operating system descriptor 
that is returned to the operating system in response to a USB device request as 
discussed above. In this implementation, the string descriptor index is OxEE, 
however it could be stored at some other location in the USB device. 

TABLE 1 

Example of an Operating System String Descriptor 

const byte os_descriptor[]={ 

0x12, //length 

0x03, // string descriptor type 

_M_,_S_,_F_,_T_,_1_,_0_,_0_, //data 

0x01, //index 

0x00 //reserved 

}; 

Next, the property descriptor is stored in a format specified by the operating 
system on the firmware of the USB device. The property descriptor is shown 
below in TABLE 2. In this implementation, the USB device is a USB compatible 
memory stick and the property descriptor defines a string property of the USB 
device. 
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TABLE 2 

Example of a Property Descriptor for a USB Memory Stick Device 



const byte mem_stick_descriptor[]={ 
0x00000044, 
0x01000, 
0x0005, 
OxOOOL 



//header section 

// dwLength (DWORD) 

// bcdVersion 

// wlndex 

// wCount 



0x0000003A, 
0x00000001, 
0x0016, 

_d_,_e_,_v_,_i_ 

0x00000016, 



// custom property section 
// dwSize 

// dwPropertyDataType 
// wPropertyNameLength 
//bPropertyName 
_E_ 5 _G_,_R_,_0_,_U_,_P_, 

//dwPropertyDataLength 
//bPropertyData 



_M_ 5 _E_,_M_,_0_,_R_,_Y_,_S_,_T_ 5 _I_,_C_,_K_, 



When the USB memory stick device is attached to the USB port on the 
computer, the operating system retrieves the property descriptor from the memory 
stick by using the following API call: 

GETJDESCRIPTOR( 

bmRequestType = 1 1 00 000 1 B, // device-to-host data transfer 

bRequest = 0x0 1 , // this request 

wValue = 0x0000, // string descriptor indication 

wlndex = 0x0005); // identification for this descriptor 

More particularly, the USB device receives the GET DESCRIPTOR 
device request and in response returns the property descriptor to the operating 
system. Upon receiving the property descriptor, the operating system extracts the 
GUI information to display special names, icons, URLs, and the like, to present a 
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GUI that is appropriate for the device. By having this information present in the 
firmware of the USB device, a user only needs to attach the device to a host 
computer, rather than use additional installation media to obtain the GUI 
information. 

Conclusion 

Traditional systems and procedures typically require OEMs/IHVs to 
distribute installation media such as installation disks or setup programs with each 
USB device to specify device-specific UI information. In contrast to such 
traditional systems and procedures, the inventive concepts described above 
provide for the use of a host-specific device request to obtain device-specific UI 
information from a USB device. Thus, in contrast to such traditional systems and 
procedures, OEMs and IHVs that implement the host-specific device request for 
an extended property descriptor are not required to distribute installation media 
with each USB device to specify device-specific UI information. 

Although the subject matter has been described in language specific to 
structural features and/or methodological steps, it is to be understood that the 
subject matter defined in the appended claims is not necessarily limited to the 
specific features or steps described. Rather, the specific features and steps are 
disclosed as preferred forms of implementing the claimed subject matter. 
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